home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / bguti23.zip / BGUTI.DOC next >
Text File  |  1990-05-20  |  14KB  |  255 lines
  1.  
  2.               VOICE               B.J. GUILLOT               MODEM
  3.          (713) 893-9123       2611 RUSHWOOD CIRCLE      (713) 893-9124
  4.                              HOUSTON, TX 77067-1941
  5.  
  6.               Copyright B.J. Guillot 1989-90, All Rights Reserved.
  7.  
  8.          --------------------------------------------------------------
  9.          BGUTI 2.2                                            20 MAY 90
  10.          --------------------------------------------------------------
  11.  
  12.                  GT POWER 15.XX UNIVERSAL TEXT INTERFACE DRIVER
  13.                    FOR RELAYNET AND MEGAMAIL DOOR INTERFACING
  14.  
  15.          --------------------------------------------------------------
  16.          ABSTRACT
  17.          --------------------------------------------------------------
  18.  
  19.          This  UTI corresponds with Kip Compton's Revision 2 Standards.
  20.          As a result,  you now  not only have the option of joining any
  21.          PC Relay Network, but you can use the new mail door, MegaDoor,
  22.          on your system to allow your  users to  download  mail packets
  23.          and read new mail on  their own system giving your system more
  24.          time for callers  to come in.   It  allows your users  to read
  25.          the messages  on their  own time,  at  their own pace.   Since
  26.          MegaDoor uses UTI drivers,  the MegaDoor/MegaRead combo can be
  27.          used on any  BBS system,  so your users will not have to learn
  28.          all of GT Power's commands besides how to open a door.
  29.  
  30.          --------------------------------------------------------------
  31.          ODDITIES
  32.          --------------------------------------------------------------
  33.  
  34.          Any mention of  "RelayNet"  in this  documentation  also means
  35.          RelayNet  International  Message  Exchange  (RIME),   Intelec,
  36.          QuickLink,  or  any   existing  network   using  Kip Compton's
  37.          PC Relay Networking Software.
  38.  
  39.          If  you are already an GT Network Sysop, you may find RelayNet
  40.          strange in some aspects.   For  example,  you  use a SCRIPT to
  41.          call your RelayNet HUB at a TIME CONVIENIENT FOR  BOTH OF YOU.
  42.          You,  as a RelayNet Node, are unable to call any other node on
  43.          the RelayNet Network.  You  ONLY call your HUB to get echomail
  44.          conferences, i.e., there is no Mail Driver program.   You will
  45.          be   REQUIRED   to   carry   the  RelayNet  "Common"  Echomail
  46.          conference, which is carried by ALL RelayNet Nodes, Hubs, etc.
  47.  
  48.          An interesting feature of RelayNet  and this driver is that it
  49.          gives you complete echomail "threading" abilities,  i.e.,  you
  50.      can be directed to the original message, (also see syntax).
  51.  
  52.          --------------------------------------------------------------
  53.          INCLUDED FILES
  54.          --------------------------------------------------------------
  55.  
  56.                   BGUTI.DOC  -  This File, Main Documentation .........
  57.                   BGUTI.NEW  -  New Information .......................
  58.                MEGADOOR.BAT  -  Sample Batch File for MegaDoor ........
  59.                   RELAY.BAT  -  Sample Batch File for  RelayNet 0.9ß12A
  60.                   RELAY.SCR  -  Sample Script for Calling Hub .........
  61.                  RELAY1.SCR  -  Sample Fancy Script by Jim Kreyling ...
  62.                 UTIDOOR.EXE  -  Sends MegaDoor the Baud Rate, Etc. ....
  63.                 UTIHIGH.EXE  -  Finds Highest Message Number ..........
  64.                UTIEXPRT.EXE  -  Bags Mail from GT into UTI Format .....
  65.                UTIIMPRT.EXE  -  Distributes Mail from UTI Format to GT.
  66.                 UTILIST.EXE  -  Sends MegaDoor GT Message Area Data ...
  67.                UTILSTRD.EXE  -  Reads/Update User Last Read Pointers ..
  68.                  UTIVER.EXE  -  Displays UTI Revison Number and ID ....
  69.  
  70.          I, for one, hate having multiple  EXE  files,  but you need to
  71.          remember, I am programming for a "standard", and cannot change
  72.          the way things work.
  73.  
  74.          You do not need any of  the  GT  Network  files: NODELIST.BBS,
  75.          ROUTING.BBS, MBAGxxx.COM, MDRIVxxx.COM, or MDISTxxx.COM unless
  76.          you are also running with the GT Network.
  77.  
  78.          --------------------------------------------------------------
  79.          REQUIRED FILES -- MEGADOOR
  80.          --------------------------------------------------------------
  81.  
  82.          In order  for your users  to use  MegaDoor,  they will need to
  83.          first download the MegaReader program.  Currently MREAD10.ZIP.
  84.  
  85.          Copy all the UTI*.EXE files into your MegaDoor directory.   If
  86.          you are also  planning on  running RelayNet, ...   I would put
  87.          the  UTI*.EXE  files  and  MegaDoor  files  in  your  PC Relay
  88.          directory to save space.
  89.  
  90.          GTUSER.BBS, GTMDIR.BBS, and  USER.CTL  must all reside in your
  91.          GTPATH directory.  MESSAGE.CTL and USER_MSG.CTL files are also
  92.          accessed by  MegaDoor  depending on  what conferences the user
  93.          is joined in.
  94.  
  95.          The user can only  send/receive  mail from conferences that he
  96.          or she is joined in.   The user  has control from their system
  97.          to set the last read pointers of  GT  to whatever they specify
  98.          They  may remove a message area by using the  UN)Join  command
  99.          off the main menu,  or join a message area by using the  A)rea
  100.          Change command off the main menu.
  101.  
  102.          --------------------------------------------------------------
  103.          REQUIRED FILES -- RELAYNET
  104.          --------------------------------------------------------------
  105.  
  106.          In  order  for you to become a RelayNet Node, you will HAVE TO
  107.          register the RelayNet Node Software, currently thrity dollars.
  108.          Please consult your RelayNet Hub for help in  setting  up  the
  109.          basic parts.   (A discount is availble for registered users of
  110.      any networking software, including GT, (see PCRELAY.TXT)).
  111.  
  112.      You will not be able to run the CONFIG.EXE  program until your
  113.      hub fetches your ID files for you.  This process usually takes
  114.      around fourty-eight hours.
  115.  
  116.          Make sure, when your Hub tells you to run CONFIG.EXE, that you
  117.          select the option called  "UTI Driver Revision 2" under system
  118.          type and not "PC Board", "RBBS", or "UTI Driver".
  119.  
  120.          As per the request of  the  RelayNet manual, I  am supposed to
  121.          tell you what your conference ID's are.  For this driver, they
  122.          will  be  the  paths of the  GT message  bases,  as  specified
  123.          in your GTMDIR.BBS  file.   For  example,  if you have this in
  124.          your GTMDIR.BBS...
  125.  
  126.                W ^D:\MAIL\RNET004 RelayNet Common Conference
  127.  
  128.          ...your  Conference  ID  for  the "Common" Conference would be
  129.          "D:\MAIL\RNET004" (without the quotes).
  130.  
  131.          If you don't understand  the  basic  setup of RelayNet, please
  132.          consult  your  Local  RelayNet  Hub system or me  for  further
  133.          details.
  134.  
  135.          --------------------------------------------------------------
  136.          HOW TO RUN BGUTI -- RELAYNET
  137.          --------------------------------------------------------------
  138.  
  139.          Make sure you have the UTI*.EXE programs in the same directory
  140.          with all your RelayNet programs, as well as the RELAY.SCR file
  141.          in your Script Directory, (as specified by GT Power).
  142.  
  143.          You, yourself, never need to run the UTI*.EXE files.  They are
  144.          shelled to by EXP.EXE and IMP.EXE,  and my programs are mainly
  145.          transparent.   All  high number  storage and tracking are kept
  146.          up transparently also.   All  you need  to do  is sit back and
  147.          relax.  Again, the UTI driver is run transparently by PCRelay.
  148.  
  149.          You use PCRelay's CONFIG.EXE to add/delete conferences  as you
  150.          need to.  BGUTI  is  capable of  "auto-priming".   After doing
  151.          this,  BGUTI  will  promt  your  for  an  "access  level"  and
  152.          "description" for the conference and will automatically append
  153.          it to your GTMDIR.BBS file.
  154.  
  155.          Messages sent to PCRelay will me marked as  <MAILED>  on  your
  156.          system to help you discover if the software is working  right,
  157.          and messages imported from PCRelay will be marked as <NO KILL>
  158.  
  159.          To use "bridge" mode  (in which  the  rcvd/mailed  flag is not
  160.          messed  with  at all),  simply prefix  the  message  directory
  161.          pathname with a  "$"  via the  CONFIG.EXE  program.   Messages
  162.          exported in "bridged" mode have their "Route:" lines stripped,
  163.          and there origin lines  are stripped to one line.   The phrase
  164.          ".ORIGIN:" is changed to "* AfsNet:".
  165.  
  166.          --------------------------------------------------------------
  167.          TROUBLE SHOOTING -- MEGADOOR
  168.          --------------------------------------------------------------
  169.  
  170.          Q) When I try to run the door locally,  MegaDoor tells me that
  171.             there is no such thing as COM Port 0.
  172.          A) A  seperate  batch file  is required  for  running MegaDoor
  173.             locally.   Check  out  the  LOCAL.BAT  file  included  with
  174.             MDOOR10.ZIP.
  175.  
  176.          Q) UTIDOOR.EXE  is  not  reporting the correct  DTE Baud Rate.
  177.          A) If you are running a version of GT prior to 15.10 Beta #11,
  178.             users with different  DTE/DCE Baudrates will not be able to
  179.             use MegaDoor.  Sorry,  but there is nothing I can do to fix
  180.             this.
  181.  
  182.          Q) Users   with   one  named  handles  cannot  use   MegaDoor.
  183.          A) If you are running a version of GT prior to 15.10 Beta #11,
  184.             users with one named handles cannot use MegaDoor.
  185.  
  186.          Since MegaDoor and MegaRead are not my products,  there is not
  187.          much else I can help you with.   You will need to get in touch
  188.          with  Kip Compton  for additional help if you are positive the
  189.          UTI driver is not causing the problem.
  190.  
  191.          --------------------------------------------------------------
  192.          TROUBLE SHOOTING -- RELAYNET
  193.          --------------------------------------------------------------
  194.  
  195.          Some of this material may be duplicated,  but after all,  this
  196.          may be the only part of the documentation some people read.
  197.  
  198.          Q) When I run CONFIG,  it immediately quits to DOS saying it's
  199.             missing the ID file.
  200.          A) You first have to contact your hub or regional hub and tell
  201.             them you need to get an ID file to join the network.   They
  202.             will tell you what other information they need.
  203.  
  204.          Q) When I attempt to add a conference with CONFIG,  it asks me
  205.             for an "ID:".
  206.          A) The  "ID:"  will be the message area pathname of the  echo.
  207.             It should be identical to what's listed in your GTMDIR.BBS.
  208.  
  209.          Q) When the  UTI  programs  are shelled to,  they come up with
  210.             numerous RUNTIME ERRORS and FILE NOT FOUNDS.
  211.          A) Did  you  run  CONFIG.EXE  to  add  and   "auto-prime"  the
  212.             conferences?
  213.  
  214.          Q) How do people send private echomail  messages to my system,
  215.             and are they intercepted at any other node?
  216.          A) Private messages  can only  be  intercepted by the Sysop of
  217.             the board the  user  is on.   To receieve private messages,
  218.             you must  create a  private  mailbox  using the  CONFIG.EXE
  219.             program or sending a  special message  to the network.  See
  220.             the document files that come with PCRelay for more info.
  221.  
  222.          --------------------------------------------------------------
  223.          OTHER INFORMATION
  224.          --------------------------------------------------------------
  225.  
  226.          I would suggest to use  Sysop's Tools or  JDCTL.EXE  to delete
  227.          messages rather than using the OZ DELMSG.EXE program.  It does
  228.          not  kill  deleted headers  and makes the  UTI  functions much
  229.          slower.  I would also suggest not to renumber the messages, as
  230.          that could cause  some problems with the  UTI  driver  knowing
  231.          what messages have already been exported.   If,  however,  you
  232.          still wish to renumber messages,  you MUST run RESET.EXE AFTER
  233.          running  the  renumbering  problem,  and you  MUST  delete the
  234.          THREAD.xxx files in your PC Relay directory.
  235.  
  236.          This program was made with Turbo Pascal 5.5 on a Tandy 1000 SX
  237.          computer.  This program is not LAN specific.  Source code will
  238.          be availble only to Registered GT Developers.   You may modify
  239.          the  source  code  in  any  way  you  need to, but you are not
  240.          allowed the distribute the changed programs and/or source code
  241.          to  any  other user of this program, (as by the  GT  Developer
  242.          Toolkit Contract).
  243.  
  244.          All   EXE   files   have  been   compressed  with  LZEXE 0.91.
  245.  
  246.          If  you have any suggestions or comments please  address  them
  247.          to me via "Sysops"  or "Admin" confernces in RelayNet,  or the
  248.          original GT companions conference or at  AFS Net/Node 440/003.
  249.  
  250.          No registration of this  program  is required, yet I recommend
  251.          you register GT Power 15/MegaRead if you have not already.
  252.  
  253.      Regards,                     Relay TRANQUIL
  254.          B.J. Guillot                                    (713) 893-9124
  255.